home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
JCSM Shareware Collection 1996 September
/
JCSM Shareware Collection (JCS Distribution) (September 1996).ISO
/
screenut
/
wrdgrb12.zip
/
WRDGRB.TXT
< prev
Wrap
Text File
|
1995-12-05
|
26KB
|
642 lines
WRDGRB 1.2
Copies Words From DOS Screen to Command Line
Copyright (c) 1995 by David M. Wincelberg
Table of Contents
I. Introduction ............................................ 1
II. How to Use .............................................. 2
III. Free Upgrade Policy ..................................... 4
Appendices:
A. Command Line Switches ................................... 4
B. Initialization File (WRDGRB.INI) ........................ 6
C. Registration-Reminder Screen ............................ 7
D. Troubleshooting ......................................... 8
E. Other FileJockey Software Products ...................... 8
F. License Agreement ...................................... 10
I. Introduction
Thank you for trying WRDGRB. With WRDGRB installed, you will no
longer type words or other text you see on the DOS screen!
Instead, you will press the hot-key sequence, highlight text with
your mouse, and left click to copy it to the command line (or
right click to cancel). WRDGRB even connects a filename to its
extension when both are highlighted in a directory listing.
This 23K memory resident or terminate and stay resident
(TSR) program is safe to run on a Pentium processor since it does
not perform any floating-point divisions of large numbers. In
addition, FileJockey Software does not release products with
known bugs.
If you decide to keep this program, paying the $30 license
and registration fee will result in your receiving:
1) a code to bypass the registration-reminder screen,
2) WRDGRB and maximizing-available-memory tips,
3) technical support,
4) notices of upgrades and bug fixes, and
5) eligibility for a free upgrade.
In addition, you will be promoting continuing product development
and using this program legally. Otherwise, you may not keep the
individual files on your PC. But, you may keep the .ZIP file. A
registration form containing my postal address is provided for
you in the file WRDGRB.REG.
Please send comments, suggestions and problem reports to me
at 71573,1023 by CompuServe e-mail, at 71573.1023@compuserve.com
by Internet e-mail, or at my postal address, even if you are not
currently a customer.
WRDGRB requires an installed mouse, DOS 4.0 or later, and a
hard disk labeled C:. (It does not have to be installed on this
disk.)
II. How to Use
II.A. Installing to Memory
To install WRDGRB, enter
WRDGRB
at the DOS prompt. You may wish to install this program from
your AUTOEXEC.BAT start-up file. Do not install this program
when you are using the go-to-DOS feature of an application
program unless you remove WRDGRB from memory before returning to
that program. See Appendix A for program options.
II.B. Unloading from Memory
To remove WRDGRB from memory, enter
WRDGRB /U
at the DOS prompt. Then, WRDGRB sends an unload/deactivate order
to its in-memory copy, prints the first part of the status
message:
WRDGRB is ...
and returns to the DOS prompt. Within one second, the program
will finish the status message with either "unloaded" or
"trying". "Trying" will be changed to either "unloaded" or
"deactivated" within another 1 1/2 seconds, depending on whether
or not any programs loaded after WRDGRB are still in memory.
If the "deactivated" message is printed and you still want
to unload WRDGRB, remove any subsequently loaded programs and
issue the unload command again. To reactivate the program, enter
WRDGRB again.
II.C. At the DOS Screen
Page 2
When you see a filename, word or other text that you want to copy
to the command line, press <Ctrl>-<Right shift>-W to activate
WRDGRB and the mouse cursor. Use the mouse cursor as you
normally would to highlight text.
For example, position the cursor at the start of a word,
press and hold down the left button, and drag the cursor to the
right one space past the word. As you do so, the word will be
highlighted. Release the mouse button. At this point, you may
type text to go before the highlighted word. (You may also type
text after activating WRDGRB but before highlighting text.)
Then, click the left mouse button to copy the selected text
to the command line or the right button to cancel the selection.
In either case, the highlighted text will be restored to how it
was if you don't change its position by pressing <Enter>, for
example. If you double left or right click, the selection will
be handled as above but the mouse cursor will re-appear to wait
for another selection. See the table below.
Left Button | Right Button
-------------------------------------------------
Single click | send text | cancel |
----------------------------------------------------------------
Double click | send text & | cancel & |
| wait for more text | wait for more text |
-------------------------------------------------
You can also highlight an entire word at once by double
left-clicking on it. (A word is defined to be a sequence of
valid DOS filename characters plus dot (.), question mark (?) and
star (*). See your DOS manual for a complete list.) The mouse
cursor jumps to one space past the word. Then you can deselect
characters from the end of the word by moving the mouse cursor
back toward the beginning of the word while continuing to hold
down the left mouse button. Once you have double clicked on a
word, you can highlight text to the right by continuing to hold
down the left mouse button and dragging the mouse to the right.
If you highlight a filename and its extension as part of a
directory listing, WRDGRB will send the name to the command line
in the form FILENAME.EXT. In other words, the intermediate
space(s) will be changed to a single period. One way to
highlight a filename is to double-click on its basename -- the
part before the dot and extension.
WRDGRB works in the 25 x 80, 43 x 80 and 50 x 80 text screen
modes.
Page 3
II.D. In a Windows 3.1 DOS Box
WRDGRB works in a full screen Windows 3.1 DOS window. However,
you may need to add the line
MouseinDOSBox=1
to the [NonWindowsApp] section of Windows 3.1's SYSTEM.INI file.
If you install WRDGRB after starting Windows, be sure to remove
it before closing the DOS window.
II.E. Copying to an Application Program
Although WRDGRB can be used with some application programs, it is
not designed for this purpose. When doing so, be careful not to
press a mouse button until you are ready to send the highlighted
text to the program. In addition, you may need to press a shift
key after sending text in order for the program to realize that
there is keyboard input to read.
Problems that may occur include your computer freezing if
you later call WRDGRB from DOS and losing the mouse cursor. To
restore the cursor, use the application-program's go-to-DOS
feature and return (by entering EXIT). The program should then
redraw the screen and restore the mouse cursor.
III. Free Upgrade Policy
FileJockey Software will not charge an upgrade fee to registered
users who provide a non-trivial suggestion or bug report that is
implemented or fixed. Excluded from this policy are suggestions
to make the program smaller, faster or cheaper. All policy
decisions of FileJockey Software are final.
The motivation for this policy is noticing that some
software would be *just right* if only the author(s) made a few
minor changes or bug fixes. Wouldn't be nice if we could get
slightly improved or fixed software without paying extra? Now
you can if you register FileJockey Software products.
Appendices
A. Command Line Switches
Entering
WRDGRB /?
Page 4
produces the following summary of command line switches or
options:
WRDGRB [switches]
/U Unload WRDGRB from memory
/L Allow including the last screen column
/N Do not print pop-up instructions
/D:sss Mouse double click threshold (in 1/1000 seconds)
/H:x Hot key letter to use with <Ctrl>-<Right shift>
/R:nnnnn Recognition code: choose a 5 digit whole number
< 32767
/S Display SiteCode (and re-write WRDGRB.REG)
/I:initname Alternate initialization filename (with path)
Follow /L or /N with '-' to override WRDGRB.INI
setting(s)
When you highlight text, the mouse cursor position is
normally not part of the selected text. This prevents you from
including characters in column 80 in the selected text. If you
think that you might want to include these characters, use the /L
switch. This causes WRDGRB to include the following character
whenever a column 79 character is highlighted. If you set this
feature to be on in WRDGRB.INI, you may use /L- to turn it off
when loading WRDGRB.
The default double click threshold is 1/2 a second. If
within this time you click the same button twice, it will
register as a double click. You can change the threshold to a
positive time delay less than 32.7 seconds. For comparison,
Windows 3.1's mouse dialog box allows thresholds between 0.1 and
0.9 seconds with a default of 0.452 seconds.
Since another TSR might use the same hot key sequence, the
/H switch allows you to change the letter that you press along
with <Ctrl> and <Right shift> to activate WRDGRB. Note that PCs
distinguish between the right and left shift buttons under
certain circumstances. For more control over the hot-key
sequence, see Appendix B.
You will need to change WRDGRB's or another TSR's
recognition code if both use the same code and you wish to have
both in memory at the same time. This code is a number WRDGRB
stores in memory to prevent installing two copies of itself. You
will know that changing the code is necessary if either program
incorrectly reports that it is already loaded. Then, if you
decide to change WRDGRB's code, select any positive five digit
whole number less than 32,767 and try installing WRDGRB with this
number using the /R option. If you changed the recognition code,
you must tell WRDGRB the new code when unloading the program.
Page 5
Once a recognition code works for you, place it on the
RecognitionCode= line of WRDGRB.INI.
If you decide to load WRDGRB when a list of files is already
on the screen, use the /N switch to reduce the number of lines
the screen will scroll. In particular, WRDGRB/N does not print
instructions for activating itself. This setting can be placed
in WRDGRB.INI and overridden by /N-.
WRDGRB will occasionally display a two-part registration-
reminder screen when initializing unless you place the bypass
code in the initialization file. This code depends on another
code (SiteCode) that appears on this screen. In addition, the
first screen contains a button to write WRDGRB.REG with your
computer's SiteCode on the appropriate line. To force this
screen to appear, enter WRDGRB/S. For more information, see
Appendix C.
The switch /I allows running WRDGRB off a CD-ROM. With it,
the location of the initialization (.INI) file can be specified
to be any write-able media, such as a hard disk. Note that
WRDGRB requires that your computer have a hard disk labeled C:.
B. Initialization File (WRDGRB.INI)
As shipped, the initialization file looks like this:
[Defaults]
DoubleClick=
LastColumn=
HotToggle=
HotLetter=
RecognitionCode=
NoInstructions=
DblClkEntireName=
[Registration]
RegKey=
Notified=NO
Most of the items in the Defaults section correspond to
command-line switches. For LastColumn and NoInstructions, you
can use a non-zero number, YES, Y, TRUE, T, or ON to select the
feature. When loading WRDGRB, you can turn off these features by
using /L- or /N-, respectively. Briefly, the purpose of
LastColumn is to allow including column 80 and the benefit of
NoInstructions is to reduce the number of lines that scroll off
the screen when WRDGRB is loaded.
Page 6
Toggles consist of the <Ctrl>, <Alt>, <Left shift>, and
<Right shift> keys. The default toggles for WRDGRB's hot-key
sequence are <Ctrl> and <Right shift>. To specify other ones,
place one or more of the letters C, A, L, and R on the HotToggle=
line. To specify that no letter is to be used along with the
toggle(s), put NONE on the HotLetter= line. For example, using
both shift keys without a letter is specified by the following
settings:
HotToggle=LR
HotLetter=NONE
The DblClkEntireName entry specifies whether or not to
select an entire filename when its basename is double clicked in
a directory listing. (Basename is the part of a filename before
the optional dot and extension.) If the entire filename is
selected, clicking on the left mouse button will place it on the
command line in the DOS-usable form (FILENAME.EXT).
In order to turn off the registration-reminder screen (see
Appendix C), you need to place the correct code after the equal
sign on the "RegKey=" line. This code depends on information
about your computer that is summarized in a SiteCode.
Once you place a code on that line, the program will test it
and tell you whether or not it is correct. Afterwards, Notified
will be set to YES. This feature is useful since the random
occurrences of the registration-reminder screen prevent easily
determining if the registration key is correct.
The program will look for WRDGRB.INI in the same directory
containing WRDGRB and WGINIT (unless you use the /I switch). If
it doesn't find this file, it will give you the option of either
editing the path and filename or not reading it.
C. Registration-Reminder Screen
To inspire you to register WRDGRB, the program may display a two-
part reminder screen before it finishes initializing itself.
This screen will not appear every time since its use is affected
by a random-number generator. Registered users can bypass this
screen with the system-specific registration key (RegKey). The
key for your computer depends on a four-character code (SiteCode)
that is printed on the first screen. SiteCodes are not affected
by installing or deleting programs, creating or deleting files,
or changing configuration files.
One of the buttons on the first screen will produce a
version of WRDGRB.REG that contains your SiteCode. To force this
screen to appear, enter WRDGRB/S. Selecting the Continue button
Page 7
will usually display a second screen in which you signal your
understanding of the shareware concept by typing the displayed
word, such as AGREE. (Your typing will appear in upper case.)
As part of the response to your payment and SiteCode, you
will receive the appropriate RegKey by e-mail or postal mail,
depending on whether or not you include an e-mail address. Place
this key on the "RegKey=" line of WRDGRB.INI.
D. Troubleshooting
WRDGRB Cannot Initialize Itself:
WRDGRB calls WGINIT.EXE for initialization in order to reduce its
permanent memory needs. WGINIT.EXE must be in the same directory
as WRDGRB.EXE. You may need to extract WGINIT.EXE from
WRDGRB.ZIP or copy it from where it is stored.
^W Appears When I Try to Activate WRDGRB:
If WRDGRB is loaded, make sure you are pressing the <Right shift>
key along with a <Ctrl> key and the hot-key letter. If you
forgot the hot-key letter or sequence, enter WRDGRB/N-. It will
not load another copy of itself (unless you have changed its
recognition code with the /R switch or RecognitionCode= in
WRDGRB.INI). Instead, it will re-activate the mouse and remind
you of the hot-key sequence. If you are not certain if WRDGRB is
loaded, enter WRDGRB/N-. Or, you could use the DOS MEM command
(DOS 4.0 or later) or a system-information utility to list your
memory resident or TSR programs.
WRDGRB is Loaded But I Cannot Find the Mouse Cursor:
Try moving the mouse around. Try entering WRDGRB/N-. If those
don't work, you may need to unload WRDGRB and reload it. On rare
occasions, it may be necessary to reboot your computer.
E. Other FileJockey Software Products
Following is a list of current FileJockey Software products. All
of the compressed files for these products have extension ZIP.
In parentheses after the descriptions are the locations where the
programs may be found on CompuServe and the registration/license
fees.
E.1. System Tools
Page 8
LISTRS 1.2 -- Directory/Program List Makers With Action Options:
DIRLIST: More accurate than "dir *." Options include show files,
change to and remove directory. PROGLIST: Shows a directory's
.EXE, .COM and .BAT files in one listing to help users find the
name of the program file to run. Options include type & run,
type & wait and edit .BAT files with a user-selected editor.
Both programs correctly sort numbers within filenames. No known
bugs. (GO PCUTIL, Library 5, $15)
C2DD 1.0 -- Change to Drive/Directory and Back
This program changes the current drive/directory to a specified
pair and records path information for moving back to any of
several previous drive/directories. It can move back one pair at
a time or present a graphical pick list. C2DD can be used with
any DOS directory navigator and is useful for returning to the
starting drive/directory in batch (.BAT) files. No known bugs.
Free program by FileJockey Software. (GO PCUTIL, Library 1, $0)
E.2. Programmer Tools
SRLIB 1.1 -- LIB: Alphanumeric Filename Sorting:
SRLIB is a set of library routines to sort filenames
alphanumerically. For example, it places FILE_2 before FILE_10
and can handle long file names, leading zeros and spaces. SRLIB
is compiled for Microsoft C/C++'s and Borland TC++'s small and
large memory models. (See SRDEMO in MSLANG, Lib. 3.) New: case-
insensitive routine, 3rd space-handling option, commas-within-
numbers handling, and more. SRDEMO.C, included in SRLIB.ZIP,
reads a directory once even for an unknown number of files. GO
SWREG (#5947) to purchase SRLIB on-line. Site licenses and
source code are available. No known bugs. ($24 plus $1 S/H (by
e-mail) or $24 plus CA tax plus $4 S/H (by disk))
PROGCR 1.0 -- Prepares Programs for Copyrighting:
Protects the privacy of your C/C++ or PASCAL source code
copyright deposit by removing comments after each file's header
(which should primarily consist of your copyright notice) from
copies of the original files. Also, copies words displayed by
standard or user-specified print commands to a file for spell
checking. (GO PCPROG, Library 6, $10)
E.3. BBS-Session Tools [prices reduced]
Page 9
CFWRAP 1.1 -- Word Wrapping Tuned for BBS Capture Files:
Prepares BBS capture files for editing by removing page pause
lines ("Press <CR> for more !", etc.) and word-wrapping various
types of paragraphs (including each line starting with ">>" and
indented paragraphs). Many page pause lines are in a user-
changeable .INI file. Version 1.1 improvements include multi-BBS
support and better word wrapping. (GO PCCOM, Library 2, $5)
FRMDSK 1.0 -- Enters Text From Disk With Line Preview & Edit:
Use FRMDSK when a BBS requires you to type in lines instead of
allowing you to upload a file. It copies lines from a file to
your BBS software (or other program) after giving you options.
These options include edit line, finish file, wait, cancel,
next/previous line and another file. Works only with DOS text
programs that read the keyboard in the standard way. 66K TSR.
(GO PCCOM, Library 2, $5)
F. License Agreement
This is a legal agreement between you ("Licensee") and FileJockey
Software ("Licensor"). Licensor owns all worldwide rights,
title, copyright and other interests in and to the computer
program identified as WRDGRB 1.2 ("Software"). By using the
Software, you are agreeing to be bound by the following terms:
1. Licensor grants to Licensee the non-exclusive and non-
assignable right to use the Software for a period of 30 days
without paying a fee to Licensor. After 30 days, Licensee may
continue this right by paying $30 to Licensor.
2. Licensee may distribute copies of the Software and related
files to others provided Licensee informs the recipients that the
Software is subject to a license agreement and that the fee you
charge, if any, does not include the license fee. The attached
VENDINFO data record is hereby incorporated by reference. Any
distribution satisfying all the distribution requirements
expressed in that data record is hereby authorized.
3. Licensor hereby alerts Licensee that the Software and
accompanying documentation are provided "AS IS" without warranty
of any kind. Licensee assumes all risks involving use of the
Software and its results and performance.
4. Licensee hereby acknowledges that Licensor bears no
responsibility or liability which may arise or result from
Licensee's use of the Software. Licensee hereby waives and
Page 10
releases Licensor from any and all claims for damages, losses and
costs therefrom. In no event shall Licensor's liability for any
damages ever exceed the price paid for license and registration,
regardless of the form of the claim.
5. This license agreement shall be construed and enforced in
accordance with the laws of the State of California. This
agreement may not be modified except by written instrument signed
by both parties. If any provisions of this agreement are found
to be invalid or unenforceable by the operation of the law, then
invalidity or unenforceability of such provision(s) shall not
affect the validity or enforceability of the other provisions of
this agreement. Any dispute arising from this agreement shall be
submitted to California courts located in Los Angeles County, and
Licensee hereby submits to the jurisdiction of such courts.
All (registered) trademarks and (registered) service marks are
properties of their respective companies.
Page 11